home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 309 / tc_comp / tc_comp.doc < prev    next >
Text File  |  1989-03-25  |  14KB  |  366 lines
  1.                            TC Companion
  2.           For The Atari ST In Medium Or High Resolution
  3.                           By John Hickey
  4.                Copyright 1988, All Rights Reserved
  5.             This Program Is Distributed As Shareware!
  6.  
  7.                            INTRODUCTION
  8.  
  9.      TC Companion is a program utility I wrote to make my life 
  10. using GENIE easier and less expensive!  Basically, it allows you 
  11. to call GENIE, get a current listing of new files available for 
  12. downloading, hang up, pick the files you want to download, then 
  13. call GENIE back and download your files in one easy batch.  It 
  14. does this by working with FLASH! to create DO files for you 
  15. automatically.  Unlike other programs I have seen like this, you 
  16. do not have to do any typing, or even know what a DO file is!  
  17.  
  18.      In addition to making your downloading easier, it also makes 
  19. your post-download activities easier, with utilities for de-
  20. arcing, copying files, erasing files, renaming files, formatting 
  21. disks, viewing ASCII files, and making and deleting folders.  I 
  22. think once you start using it, you'll agree it's a complete 
  23. TeleCommunications Companion (see where the name comes from?!).
  24.  
  25.      Now, for a short message from our legal department...
  26.  
  27.                            DISCLAIMER:
  28.  
  29.      We make no implied claims or warranties as to the suitability 
  30. of this software for any particular purpose.   We are not 
  31. responsible for incidental and/or consequential damages incurred 
  32. while using this software.  We also reserve the right to upgrade 
  33. or otherwise alter this product and/or documentation without 
  34. notification of any person of such changes (although, if you are a 
  35. registered user, you WILL receive notification of any upgrades!).  
  36. Use this software at your own risk!
  37.  
  38.                          SHAREWARE ALERT!
  39.  
  40.      This software is shareware.  It may be distributed freely, 
  41. provided that no part is changed or altered.  If you use this 
  42. software, you ARE obligated to pay for it.
  43.  
  44.      Your support is appreciated, and will register you for 
  45. updates. your first upgrade will be sent to you free of charge.  
  46. It will get rid of the annoying Alert Boxes at the beginning of 
  47. the program, as well as include any last-minute enhancements 
  48. and/or bug fixes.  Future updates will be available to you either 
  49. by mail (you send a blank disk with return postage), or by BBS 
  50. (you will be placed in a special section on my Starship II BBS, 
  51. where you can download the update for just the cost of the phone 
  52. call).  With your payment, please include any suggestions 
  53. concerning this product... Thanks!
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Page 2
  60.  
  61.  
  62.  
  63.      USE THIS FORM (OR FACSIMILE) TO REGISTER YOUR SOFTWARE!
  64.  
  65. NAME: ________________________________________________________
  66.  
  67. ADDRESS: _____________________________________________________
  68.  
  69. CITY: _____________________________ ST: ______ ZIP: __________
  70.  
  71. PHONE: ____________________________
  72.  
  73. YOU WILL BE REGISTERED ON THE STARSHIP II BBS.  WE NEED TO KNOW A 
  74. HANDLE AND PASSWORD YOU WISH TO USE:
  75.  
  76. HANDLE (20 LETTERS MAX.): _____________________________________
  77.  
  78. PASSWORD (6 LETTERS MAX.): ________________
  79.  
  80. ARE YOU USING:    [] MONOCHROME    [] COLOR
  81.  
  82. SUGGESTIONS: __________________________________________________
  83.  
  84. _______________________________________________________________
  85.  
  86. _______________________________________________________________
  87.  
  88. _______________________________________________________________
  89.  
  90. _______________________________________________________________
  91.  
  92. _______________________________________________________________
  93.  
  94. _______________________________________________________________
  95.  
  96. _______________________________________________________________
  97.  
  98. _______________________________________________________________
  99.  
  100. Please send $15.00 ($25.00 if you would like the original GFA 
  101. BASIC source code) to:
  102.  
  103.                            John Hickey
  104.                          2320 Easton Ave.
  105.                        Richland, WA   99352
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117. Page 3
  118.  
  119.  
  120.  
  121.                        ON WITH THE SHOW...
  122.  
  123.      The following files should be on your disk (after you de-arc 
  124. them!)
  125.  
  126.      TC-COMP.PRG
  127.      TC_MENU.PRG
  128.      TC_COMP.DAT
  129.      TC_COMP.DOC
  130.      FLASH.CNF
  131.  
  132.      Put all of the TC_ files in the same directory (either the 
  133. main directory or a sub-directory).  TC COMPANION will also 
  134. require access to FLASH.PRG and ARC.TTP.  You can copy these files 
  135. (and any related files FLASH requires) to the same disk (or 
  136. subdirectory), but you don't have to; the program allows you to 
  137. set a path to where these files are.
  138.  
  139.      Copy the file FLASH.CFG to the same directory as your 
  140. FLASH.PRG is located.  Or, if you are familiar with FLASH, add the 
  141. line DO TC_COMP.DO to your FLASH.CFG file using the AUTO command.
  142.  
  143.      You can also run TC_COMPANION from a Ramdisk.  Simply copy 
  144. all the TC_ files to the Ramdisk and off you go!  (NOTE: TC 
  145. COMPANION uses the file TC_COMP.DAT to remember your password, 
  146. paths, etc. If you make any changes to your configuration, be sure 
  147. to copy the TC_COMP.DAT file from the Ramdisk back to your working 
  148. disk!).
  149.  
  150.      Now, run the TC_MENU.PRG.  You will be prompted for the 
  151. correct time and date (IMPORTANT! Always make sure you have the 
  152. correct Time and Date set!  TC_COMPANION uses the date to save 
  153. your Browse Files!!)  After you set the date, the TC_MENU logo 
  154. appears. Drop down the FILES menu, and select RUN TC_COMPANION.  
  155. After a few moments, you're in the COMPANION and ready to start.
  156.  
  157.                     SET UP YOUR CONFIGURATION
  158.  
  159.      Under the heading IMPORTANT are several items you need to set 
  160. up. First, go to SET ROUNDTABLES/PATHS.  This section tells the 
  161. program what you want to call the GENIE sections, what page in 
  162. GENIE they are on, where you want to save your BROWSE files, and 
  163. where you want to save your DOWNLOAD files.  Example paths are 
  164. already set. Change them as you will, but remember, when setting a 
  165. path, always put the "\" character on the end!  Do not worry if 
  166. you have not already created the folders that you type in... 
  167. COMPANION will create them for you!  (NOTE FOR SINGLE DRIVE USERS:  
  168. You may want to use drive B as your download and browse path; that 
  169. way, your ST will prompt you to switch disks whenever it needs 
  170. your data disk.).
  171.  
  172.  
  173.  
  174.  
  175. Page 4
  176.  
  177.  
  178.      You will also tell COMPANION the directory where your FLASH! 
  179. program and ARC.TTP are located.  IN ALL CASES, ONLY TYPE IN THE 
  180. NAME OF THE DIRECTORY WHERE THE FILES ARE LOCATED, NOT THE 
  181. FILENAME ITSELF!  When you're done, click on OK.
  182.  
  183.  
  184.  
  185.      Next, set up your GENIE SPECIFICATIONS.  Here, you will tell 
  186. the program your GENIE ID and PASSWORD, the phone number to call, 
  187. and how many times you want it to re-dial.  When you're done, 
  188. click on OK.
  189.  
  190.      Finally, you will want to set your Baud Rate.  click on 300, 
  191. 1200, or 2400.  Then, click on SAVE CONFIGURATION.  Now, you won't 
  192. have to set these the next time you use the program.
  193.  
  194.                           CALLING GENIE
  195.  
  196.      Now it's time to call GENIE and get a listing of new files.  
  197. Under the FILE heading, select BROWSE FROM LAST DATE CALLED or 
  198. BROWSE BY SEARCH STRING.
  199.  
  200. If you select:
  201.  
  202. BROWSE FROM LAST DATE CALLED:  You will be presented with a list 
  203. of the Roundtables that you use.  Click on the ones you want to 
  204. browse. When done, click on  CLICK WHEN DONE (is this easy or 
  205. what??!). You will be asked if you want to stay on GENIE or hang 
  206. up after you browse.  Click on whichever you want to do.  A DO 
  207. file will then be created n your FLASH disk.
  208.  
  209. BROWSE BY SEARCH STRING: A box will pop up that will let you 
  210. select how many days back you want to browse, and the Search 
  211. String you wish to search for.  You may type ALL under "Number Of 
  212. Days Back" if you wish to look at all files for a particular 
  213. Roundtable.  When done, click on OK.  You will be asked if you 
  214. want to stay on GENIE or hang up after you browse.  Click on 
  215. whichever you want to do.  A DO file will then be created on your 
  216. FLASH disk. 
  217.  
  218.      Now, go to FILE and QUIT.  You are now back to TC_MENU.  
  219. Click on RUN FLASH!.  FLASH! will run, execute the DO file, get a 
  220. listing of the files you requested, save them to disk, then return 
  221. to TC_MENU quick as a wink!!!  (NOTE!  If using BROWSE FROM LAST 
  222. DATE CALLED for the first time, and if you have not previously 
  223. used this option on GENIE before, you may have to hit your BREAK 
  224. key (usually CONTROL Z) in order to stop the listing.  You will 
  225. only have to do this once!)l
  226.  
  227.                       NOW FOR THE FUN PART! 
  228.  
  229.  
  230.  
  231.  
  232.  
  233. Page 5
  234.  
  235.  
  236.      Select RUN TC_COMPANION.  After TC_COMPANION comes up, go to 
  237. FILE and select  SELECT FILES TO DOWNLOAD.  you will get a 
  238. selector box that asks if you wish to input from the Keyboard or 
  239. File.  Select FILE.  Then, you will be asked which Roundtable to 
  240. download from.  Now, a file selector box appears, with a file 
  241. listed something like 1A090988.TXT (a quick explanation; the "1" 
  242. is for the Roundtable you have selected (1-5).  The "A" means that 
  243. is the first one you did for the day (the 2nd would be "B", the 
  244. 3rd a "C", etc.  This way, you can scan the same Roundtable 
  245. several times in one day without erasing previous browse listings.  
  246. The rest is the date when you BROWSED the roundtable.).  Click on 
  247. the file and click OK.  Now it gets neat!
  248.  
  249.  
  250.  
  251.      A description of a file will appear in the upper left corner 
  252. of the screen.  If you want to download it, click on YES.  The 
  253. file will be listed on the screen as a selection, and a new file 
  254. will appear in the upper left corner.  If you don't want to 
  255. download the file, click on the arrow pointing right (forward) to 
  256. get a new file listing. you can go backward, too!  Now, check out 
  257. the bottom of the screen;  it tells you how many bytes worth of 
  258. files you are downloading, and the approximate time it will take 
  259. to download them (based on the Baud Rate you have selected)! Keep 
  260. selecting files until the end of the list.  If you need to edit 
  261. the listing (delete or change a name), just point to the file you 
  262. need to edit.  Click on the left mouse button to edit the name or 
  263. number, or the right mouse button to delete the file from the 
  264. list.
  265.       
  266.      When you are done selecting files, click on QUIT.  Now, if 
  267. you have any more Roundtables that you Browsed earlier, just 
  268. repeat the above sequence, but select the new roundtable.  After 
  269. you are done selecting files, you may want to make sure you have 
  270. enough room on your data disk (or whatever path you selected in 
  271. the configuration stage for downloads) to download all the files.  
  272. Under UTILITIES, there is a selection CHECK FREE DISK SPACE.  
  273. Pretty handy, eh?
  274.  
  275.      If you find you have selected more files than you have space 
  276. or time to download, you may select EDIT DOWNLOAD FILE to delete 
  277. some of your selected downloads.
  278.  
  279.      You can also select which kind of download protocol you wish 
  280. to use. The program defaults to YMODEM BATCH, and I recommend you 
  281. leave it as that.  However, you may use whichever protocol you 
  282. feel most comfortable with.
  283.      
  284.      Make sure the disk with your FLASH! program is in the drive, 
  285. then select SAVE DOWNLOAD DO FILE.  You will be asked if you want 
  286. to stay on GENIE or hang up after you download.  Click on 
  287. whichever you want to do. A DO file will then be created on your 
  288. FLASH disk.
  289.  
  290.  
  291. Page 6
  292.  
  293.  
  294.  
  295.      Now, go to FILE and QUIT.  you are now back to TC_MENU.  
  296. Click on RUN FLASH!.  FLASH! will run, execute the DO file, 
  297. download all the files you have selected, then return to TC_MENU, 
  298. quick as a wink!!!
  299.  
  300. JEEPERS THAT WAS QUICK AND EASY! BUT WAIT, THERE'S MUCH MUCH MORE!
  301.  
  302.      Now that you've downloaded everything, you probably need to 
  303. de-ARC them.  TC_COMPANION has a powerful DE_ARC utility!  Run the 
  304. TC_COMPANION again.  Under the ARC heading, you can select several 
  305. parameters. The default is to automatically make folders for the 
  306. ARCed files to go into, NOT erase the original ARCed files, and 
  307. NOT confirm each de-ARC.  Change these as you want (although I 
  308. would recommend you only erase COPIES of your original downloaded 
  309. ARC files!).  Now, select DE-ARC FILE(s).  Follow the prompts.  
  310. You can de-ARC only selected files, or all the files in a 
  311. directory or sub-directory.  The program will even automatically 
  312. create a new folder for you to place all your new de-ARCed files 
  313. into! Nifty, eh?
  314.  
  315.                           SO WHAT ELSE?
  316.  
  317.      TC COMPANION has all sorts of other neat utilities, like Copy 
  318. files, delete files, make/delete folders, rename files, read Text 
  319. files, and ARC files.  They're all pretty self-explanatory.  If 
  320. you have any questions, register and I'll answer them!
  321.  
  322.                      SUPPORT AND THE FUTURE.
  323.  
  324.      When you register your software, you will be sent a new disk 
  325. with any current ehancements/bug fixes, those nasty ALERT boxes 
  326. gone, and information on how to reach me by phone, and where to 
  327. call by BBS for future upgrades.
  328.  
  329.      This is the ONLY version of TC COMPANION that will be 
  330. released to the general public.  All future enhancements will be 
  331. available ONLY to registered owners!  Some of these enhancements 
  332. that I have in mind are:
  333.  
  334.      * Support for quick capturing of new messages and topics in 
  335. the message base
  336.  
  337.      * Support for the new ST-TALK PROFESSIONAL Script Language
  338.  
  339.      * Improved COPY FILES function
  340.  
  341.      * Support for more than 5 Roundtables
  342.  
  343.      * Whatever else may pop-up!
  344.  
  345.  
  346.  
  347.  
  348.  
  349. Page 7
  350.  
  351.  
  352.  
  353.     Remember, the only way to get the upgrade is to register!  I 
  354. firmly believe that if you use TC COMPANION, you will SAVE MONEY 
  355. by using less time while browsing and downloading.  And with 
  356. GENIE, time is money, so you should make up the registration fee 
  357. in no time flat!  So, what are ya waiting for??  Fill out the form 
  358. and send it in!
  359.  
  360. Thanks,
  361.  
  362. John Hickey
  363. (GENIE ID: J.HICKEY)  (Write Me!)
  364.  
  365.  
  366.